home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 September / macformat-041.iso / mac / Shareware in MacFormat / KitCat / ReadMe.txt < prev   
Encoding:
Text File  |  1996-05-26  |  5.6 KB  |  161 lines  |  [TEXT/KAHL]
  1. KitCat
  2. ------
  3.  
  4. This version was supposed to go out last year.  However, as I
  5. spent lots of time trying to get it to automagically quit at
  6. shutdown under System 6, without much luck I must add, I ended
  7. up postponing its release.  Anyway, here it is the new version of
  8. KidCat.  I hope you like it!
  9.  
  10. KitCat is a simple application that looks like a wall-mounted Cat 
  11. clock sold some years ago.  If you never saw one, it looks like a
  12. black cat with an analog clock in its belly.  As the seconds goes
  13. by, its tail and eyes swing to the left and to the right.  To 
  14. mark the hour (13:00, for instance), the clock would meow. 
  15.  
  16. REQUIREMENTS
  17.  
  18. Well, I ran KitCat under System 6 and 7 without any problems.  
  19. However, it only quits automagically ay shutdown under System 7
  20. (One of these days I will find out why it refused to do su under
  21. System 6).  It probably runs even under System 4, but I did not 
  22. try.  The program needs 37 Kb of disk space and uses 90 Kb of RAM.  
  23. It is no memory hog by any means.  I do not like Fatware. =)
  24.  
  25. INSTALLATION
  26.  
  27. There is not much to install KitCat; just put it wherever is 
  28. convenient for you and it will be as happy as it could ever be.
  29.  
  30. To run it, simply double-click its icon.  Once it is on, you 
  31. will see it pop up on the screen and begin moving its tail and 
  32. eyes.  Initially, whenever it reaches :00 minutes, it will meow
  33. once, but that can be changed:
  34.  
  35.     SETUP MENU
  36.     
  37.     There you will find one single item:  Alarm.  Bye selecting
  38.     it you will get a dialog box that allows you set up the 
  39.     Meow volume and how it meows.
  40.  
  41. HISTORY (Raison d'etre)
  42.  
  43. Some 5 years ago I went to UF computer fair and saw a DECStation 
  44. running what seemed to be an X-windows version of the Kit Cat 
  45. clock.  Inquiring the DEC representative lead to nothing -- he
  46. did not know where that program came from or how to get it -- so
  47. I decided to look for it somewhere else:  the net.  Since then,
  48. I have been looking for any lead to that program.  
  49.  
  50. During the Summer of 1994, I finally found the X11 cat clock.
  51. After some problems and conversations with the author, I 
  52. eventually compiled and installed it in my Unix account.  After
  53. that, I began wondering, "Why not port it to my Mac?"  First I
  54. simply tried to rewrite the code, but did not have much luck;
  55. my knowledge of X-windows programming is quite sorry.  So, I
  56. decided write my own program that *looks* like Philip Schnider's 
  57. X11/motif code.  Ok, ok, at least the Cat looks like Philip's.
  58.  
  59. "But," you would ask, "why write the program?"  That is a good 
  60. question.  Perhaps to have it running in your machine and 
  61. suddenly meowing loud enough to attract attention to your 
  62. screen.  Impress your friends!  Amaze you SO!
  63.  
  64. COPYRIGHT/SHAREWARE
  65.  
  66. Copyright © 1994 - 1996 Mauricio Tavares (Me!) <raub@kushana.aero.ufl.edu>
  67. All rights reserved.  I am placing this program as shareware.  If 
  68. you really appreciate this program, send me $5.00 (I am not greedy) 
  69. or a nice =) Post Card (especially if you do not live in US) so 
  70. that I know how far this program have gone.  My address is:
  71.  
  72.     Mauricio Tavares
  73.     2601 NW 23rd Blvd apt 215
  74.     Gainesville, FL 32605-2937
  75.     Earth (Sol 3), Sol solar system
  76.     Orion's Arm of the Milky Way galaxy
  77.     Local agglomerate of galaxies
  78.     Known Universe
  79.     
  80.     raub@kushana.aero.ufl.edu
  81.  
  82. If included in an anthology or collection, I would like to receive
  83. a copy of the collection.  For instance, if it is included in a 
  84. shareware CDROM, my "fee" would be a free copy of the CDROM.
  85.  
  86. ACKNOWLEDGEMENTS
  87.  
  88. Philip Schnider <pjs@netcom.com> for having written the code for 
  89.                 X11/Motif, making me want to write a port for the
  90.                 Mac
  91.                 
  92. D Neal Wise <nwise@achilles.k12.ar.us> for getting me a nice Meow 
  93.                 sound
  94.  
  95. Stefan Kurth <stk@DoBag.IN-Berlin.DE> for help with my delay 
  96.                 problem
  97.                 
  98. Daniel Gomoll <Gomolld@aol.com> For helping me with implementing
  99.                 the System 7 AppleEvents handling stuff
  100.  
  101. MuffinHead (Isca BBS) <deninger@blue.weeg.uiowa.edu> For showing
  102.                 how to read a command-key combination from
  103.                 withing a dialog box
  104.  
  105. All those who supported the program by sending money, postcards, 
  106. suggestions (very important), thank-you notes, and so on.  This
  107. version is dedicated to you.  To name a few (I have their notes 
  108. right here right now):
  109.  
  110. o Einar B Jungaard (Olso, Norway)
  111. o David Ostwald <dostwald@puc.edu>
  112. o Dant (Edinburg Scotland).  You have a worst handwriting than 
  113.         mine, something I always thought to be impossible
  114. o Mauro Ortis (Tepoztlan-Morelos, Mexico)
  115. o H & P Rigard <100733.226@compuserve.com <Montpellier, France)
  116. o Montrean (Richmond, VA)
  117.                 
  118. MODIFICATIONS
  119.  
  120. 1.1.0      - Added an option that will make the cat tell the hours 
  121.                by meowing the number of hours.
  122.                
  123.                Allow user to control the Cat volume.
  124.                
  125.                Added the code to allow it to quit if the Mac shuts 
  126.                down (System 7 only, for some obscure reason nobody
  127.                I know can find out :P ).
  128.  
  129. 1.0.0      - After testing in a Quadra 700, I found it was too
  130.              fast.  A .1s delay was added to the code. (Jan 03, 94)
  131.  
  132. 1.0.1 beta - Correct some of the resources so that is shows the
  133.              version correctly. =( (Jan 01, 1995)
  134.  
  135. 1.0.0 beta - First version.  Get the memory requirements as low as 
  136.              possible without losing the meows. (Dec 31, 1994)
  137.  
  138. TO BE DONE
  139.  
  140.  
  141. o Make the code "remember" the location of the clock window.  
  142.   Preferences Files perhaps?
  143.     
  144. o Add an alarm
  145.  
  146. o Make it quit at shutdown under System 7.  
  147.  
  148. o Clean up the code; there are too many global variables.  Try 
  149.   to group them together in some logical fashion.
  150.   
  151. o Learn how to type.  Being a three-finger typist is a pain. :P
  152.  
  153. CODA
  154.  
  155. If you have any suggestions/opinions/comments, do send them this
  156. way!
  157.  
  158. Oh, if I am not mistaken, I left some surprises in the About... 
  159. box.  Happy hunting. =)
  160.  
  161.